create_update_mod_level

 

 

Public Function create_update_mod_level(ByVal part_num As String, _

                                        ByVal domain As String, _

                                        ByVal mod_level As String, _

                                        ByVal replaces_part As String, _

                                        ByVal replaces_dom As String, _

                                        ByVal replaces_rev As String, _

                                        ByVal replaces_date As String, _

                                        ByVal status As String, _

                                        ByVal change_ml As Boolean, _

                                        ByVal new_ml As String) As Integer

 

Description

 

This API creates or update part mod levels (revisions). You must supply the part number and domain (to identify the part), and the mod_level. If the mod_level record already exists, it's an update. If it doesn't, it's a create. You may also (optionally) specify the part number/domain/revision that this revision replaces, and the date that it replaces the previous revision.

 

You may also specify the status of the revision. If you do not specify a status (for create), the status of "Active" is assumed. Also, you may use the change_ml and new_ml arguments to change the mod_level of an existing mod_level record.

 

 

Parameters         

 

Parameter Name                Required?             Description                                                                                                          

part_num                               Yes                         Part number of the part

part_dom                               Yes                         Domain of the part

mod_level                              Yes                         Revision to create

replaces_part                        No                           Part number of part/rev that this revision replaces

replaces_dom                       No                           Domain of part/rev that this revision replaces

replaces_rev                         No                           Revision of part/rev that this revision replaces

replaces_date                       No                           What date/time does this part/rev replace the previous one?

status                                     No                           The status of the revision. For creates, if blank, the status of "Active" is used.

For updates,  if it is blank, no change is made to the status. Must be a valid

status otherwise (Active, Inactive, Obsolete)

change_ml                             Yes                         For updates only (ignored for creates). Should the mod_level be updated?

Should be True or False

new_ml                                  No                           For updates only. If change_ml = True, this is the new mod_level for the

revision record

 

Returns

 

Value                                     Meaning                                                                                                                                               

0                                              No errors

-1                                             Cannot find the specified part number

-2                                             An invalid status was supplied

-3                                             Cannot find the specified replaces part and revision

-4                                             The new mod_level (updates only) supplied already exists for a revision of this part.

 

ret_objid                                Output                   Returns the objid of the mod level

 

Examples

 

·         Create revision '2.4' for product 'Zipcode Reverse Directory'. It does not replace another revision. Assume it is active.

 

Visual Basic:

 

Dim ret_int   As Integer

Dim mod_level As Long

 

ret_int = fcinter.create_update_mod_level("Zipcode Reverse Directory", _

                                          "Product", "2.4", "",_

                                          "", "", _

                                          "", "", false, "")

   If ret_int = 0 Then

      mod_level_objid = fcinter.ret_objid

   End If

 

 

Javascript:

 

var ret_int = fcinter.create_update_mod_level("Zipcode Reverse Directory",

                                          "Product", "2.4", "",

                                          "", "", "", "", false, "");

 

 

   if (ret_int == 0){ var mod_level_objid = fcinter.ret_objid; }

 

 

·         Modify revision '2.4' for product 'Zipcode Reverse Directory'. It replaces revision '2.3' of the same package on January 23rd 1998. Leave everything else alone.

 

Visual Basic:

 

Dim ret_int   As Integer

 

ret_int = fcinter.create_update_mod_level("Zipcode Reverse Directory", _

                                          "Product", "2.4", _

                                          "Zipcode Reverse Directory", _

                                          "Product", "2.3",_

                                          "1/23/98 8:00:00", _

                                          "", false, "")

 

Javascript:

 

var ret_int = fcinter.create_update_mod_level("Zipcode Reverse Directory",

                                          "Product", "2.4",

                                          "Zipcode Reverse Directory",

                                          "Product", "2.3",

                                          "1/23/98 8:00:00",

                                          "", false, "");